home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / keyb / simkey11.zip / READ.ME < prev    next >
Text File  |  1992-11-21  |  10KB  |  191 lines
  1.                    ┌─────────────────────────────────┐
  2.                    │           SimKey 1.1            │
  3.                    │                                 │
  4.                    │         Medan Software          │
  5.                    │ (c) 1992 Theo J.M. Schoenmakers │
  6.                    └─────────────────────────────────┘
  7.  
  8.     SimKey is a utility for use in DOS-batch files.
  9.  
  10.     It  automates actions  after the  start of  programs that lack the
  11.     possibility of start-up macros. SimKey  is not a TSR-program, i.e.
  12.     it  will not  occupy any   memory after  completion. It  feeds the
  13.     keystrokes you entered on the command line to the keyboard buffer,
  14.     enabling you to get straight away to business.
  15.  
  16.     You can make a hardcopy of this  file in the following way. See to
  17.     it that your  printer is connected to LPT1:  (the parallel port of
  18.     your PC) and that it is on-line. Make sure that a fixed-pitch font
  19.     (about 10 CPI) is selected. Then type at the DOS-prompt:
  20.                             COPY READ.ME PRN:
  21.     This should result in five pages being printed.
  22.  
  23.     THE LEGAL PART
  24.     You  may copy  the program  and distribute  it without  charge for
  25.     non-commercial,  non-governmental   use.  You  may   not  sell  or
  26.     otherwise charge  for SimKey. However, users'  groups may charge a
  27.     small fee for media and postage.  Please be certain that all files
  28.     are  kept together:  SIMKEY11.ARJ should  contain SIMKEY.EXE, this
  29.     READ.ME file, KEYBUF.COM and KEYBUF.SCR.
  30.  
  31.     This program is provided AS  IS without any warranty, expressed or
  32.     implied,  including but  not limited  to fitness  for a particular
  33.     purpose.  I, Theo  Schoenmakers, am  not responsible  for anything
  34.     that may happen when you  use SimKey, including hardware damage or
  35.     information loss.
  36.  
  37.     Please  remember that  SimKey 1.1  is SHAREWARE!.  If you continue
  38.     using it beyond a 30-day trial period you are expected to register
  39.     the program or  discontinue using it. Registering will  give you a
  40.     personalized  version without  the  beg-notice  and without  the 4
  41.     second  wait. It  will also  give you  a clear  conscience and the
  42.     great feeling that you have  done the right thing. Please register
  43.     SimKey! Fill out the registration  form below and send U.S.$10, or
  44.     the equivalent in your currency  (outside Europe please add U.S.$4
  45.     for additional postage costs), for EACH machine (including network
  46.     workstations) it is executed upon, to:
  47.  
  48.                              Medan Software
  49.              Theo J.M. Schoenmakers, Jan van Speykstraat 52,
  50.                   NL-6512 GZ Nijmegen, THE NETHERLANDS.
  51.  
  52.                    ----------> THANK YOU! <----------
  53.  
  54.  
  55.     Below are several  examples of how to use  Simkey. A detailed list
  56.     of keyboard scan codes used in the last example can be obtained by
  57.     typing  'Simkey'  at  the  DOS-prompt  without  any parameters, or
  58.     followed by '/?' or '/h'.
  59.  
  60.     - Start a program ('app.exe') where you always begin with '/fr'.
  61.           @echo off
  62.           simkey /fr
  63.           app.exe
  64.     Here you literally enter the desired keystrokes.
  65.  
  66.     - Start a program that requires you to enter your name ('John
  67.       Smith') and press <Enter>.
  68.           @echo off
  69.           simkey John@032Smith@013
  70.           app.exe
  71.     This example  illustrates how to  enter plain ASCII-codes.  ASCII-
  72.     codes are  preceded by a '@'.  You have to use  the ASCII-code 032
  73.     for  a  space,  or  DOS  will  assume  that  you  entered  several
  74.     parameters  (SimKey will  only look  for the  first one). Pressing
  75.     <Enter>  is  accomplished  by  putting  its  ASCII-code 013 in the
  76.     keyboard buffer.
  77.  
  78.     - Start a program in which you invariably commence with the
  79.       keystrokes Alt-F, L, <Tab>, <Space>.
  80.           @echo off
  81.           simkey !033L@009@032
  82.           app.exe
  83.     This  looks more  complicated than  it is.  Using '!' indicates to
  84.     SimKey  that a  so-called keyboard  scan code  will follow.  These
  85.     codes  are listed  by SimKey   when you  start SimKey  without any
  86.     parameters. The combination '!033'  simulates the Alt-F keystroke.
  87.     After L follow the ASCII-codes for <Tab> and <Space>.
  88.  
  89.                    This should get you up and running!
  90.  
  91.  
  92.  
  93.                           The use of KEYBUF.COM
  94.  
  95.     Starting from version 1.1, a program called KEYBUF.COM is included
  96.     with SimKey. There was a demand  for a keyboard buffer larger than
  97.     16 characters  in conjunction with  the use of  SimKey. KEYBUF.COM
  98.     provides a 128-character keyboard buffer.  It was written by Andre
  99.     Schaffers and published in  the Dutch "Personal Computer Magazine"
  100.     of May 1992. Here's how to use it.
  101.  
  102.     Try to run KEYBUF.COM as early  as possible. This program tries to
  103.     reserve a 256-byte chunk of memory  in the first 64 Kbytes of RAM.
  104.     If you have loaded  some memory-resident programs, KEYBUF.COM will
  105.     find that there  is no more memory available below  64 Kb. In that
  106.     case, it will  not reserve any memory and end  with a little beep.
  107.     Check   if  your   version  of   DOS  supports   the  use  of  the
  108.     INSTALL-command in CONFIG.SYS. If it does, add the line:
  109.                            INSTALL=KEYBUF.COM
  110.     somewhere  early in  your CONFIG.SYS-file.  If your  DOS does  not
  111.     support the use of INSTALL in CONFIG.SYS, try to run KEYBUF.COM as
  112.     early  as  possible  in  AUTOEXEC.BAT.  If  you  hear a beep, your
  113.     keyboard buffer will NOT have been extended!
  114.  
  115.     KEYBUF.COM works  by relocating the BIOS-pointers  to the keyboard
  116.     buffer. It tries  to reserve 256 bytes of RAM.  If it succeeds, it
  117.     changes the BIOS-pointers for buffer-start and buffer-end to point
  118.     to  the 256-byte  RAM-chunk. It   also changes  the head  and tail
  119.     pointers in  the BIOS to  point to the  start of the  reserved 256
  120.     bytes.  KEYBUF.COM  then  ends  with  only  the 256  bytes of  RAM
  121.     permanently reserved. The BIOS-pointers are  each 2 bytes long and
  122.     denote  the offset  to segment  0040hex. Since  two bytes can only
  123.     maximally address  64 Kb, the  start and end  of the new  keyboard
  124.     buffer have to reside within the first 64 Kb of RAM.
  125.  
  126.     If you have  really understood what is going  on, you will realize
  127.     that KEYBUF.COM is a program  that definitely should NOT, I repeat
  128.     NOT (!!), be loaded  high. It has to reside in the  first 64 Kb of
  129.     RAM. Therefore,  do not use LOADHIGH  or any other type  of memory
  130.     manager command  to load KEYBUF.COM high.
  131.  
  132.     KEYBUF.COM may  interfere with specific programs  that require the
  133.     keyboard buffer to  be in the usual place.  Not very many programs
  134.     are that  picky, but be  prepared to encounter  such problems with
  135.     very hardware-specific  applications such as  e.g. certain network
  136.     drivers.
  137.  
  138.                              Version History
  139.     Version 1.0: Initial release
  140.  
  141.     Version 1.1: Added KEYBUF.COM and KEYBUF.SCR (the debug script) to
  142.     enable the use of a 128-character keyboard buffer. SimKey 1.1 will
  143.     recognize  a  relocated  and  extended  (maximally 128 characters)
  144.     keyboard buffer.
  145.  
  146.      ________________________________________________________________
  147.     | Send completed form to:                                        |
  148.     |                        Medan Software                          |
  149.     |                       Theo Schoenmakers                        |
  150.     |                     Jan van Speykstraat 52                     |
  151.     |                      NL-6512 GZ  Nijmegen                      |
  152.     |                        THE NETHERLANDS                         |
  153.     |________________________________________________________________|
  154.     |                R E G I S T R A T I O N   F O R M               |
  155.     |                                                                |
  156.     |                          SimKey 1.1                            |
  157.     |                                                                |
  158.     | Name:________________